home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1996 February / Software of the Month Club 1996 February.iso / pc / os2 / ftaskbar / tread.me < prev    next >
Encoding:
Text File  |  1996-01-08  |  13.0 KB  |  267 lines

  1.  
  2.  ┌──────────────────────────────────────────────────────────────────────────┐
  3.  │     FM/2 Taskbar copyright (c) 1995 by M. Kimes  (Barebones Software)    │
  4.  │                            All Rights Reserved                           │
  5.  │                                  v1.02                                   │
  6.  ├──────────────────────────────────────────────────────────────────────────┤
  7.  │                TREAD.ME file -- read before installing                   │
  8.  │        See end of document for contact info and license details          │
  9.  └──────────────────────────────────────────────────────────────────────────┘
  10.  
  11.  
  12. What is it?
  13. ==========
  14.  
  15. The FM/2 Taskbar is a small utility program that works in conjunction
  16. with the WPS Window List, program objects and Launchpad to control
  17. what's running on your system and where it runs.  It's much harder to
  18. explain than to try, and since installation is quick and painless and a
  19. deinstallation program is included, I encourage you to try it and see
  20. what you think.  See sections below for the information you need to get
  21. started.  Warning:  A pointing device _is_ required; the Taskbar would
  22. make little sense without one.
  23.  
  24. If you like the Taskbar, you'll love FM/2.  File Manager/2 (FM/2) is a
  25. shareware OS/2 2.1+ PM 32-bit file/directory/archive maintenance utility
  26. (a sort of super-Drives object, something midway between the Drives
  27. objects and a more traditional file manager) with plenty of bells,
  28. whistles and utilities, drag and drop, context menus, toolbars and
  29. accelerator keys.  FM/2 won a 1995 OS/2 Magazine Editor's Choice award
  30. -- the only file management software to do so.  If you know how to use
  31. OS/2, you already know how to use most of FM/2.  You can easily glean
  32. the rest from the extensive online help.  FM/2 is available from
  33. ftp.secret.com (/g/os2utl), from Compuserve's OS2SHARE (OS2BVEN) forum
  34. (GO OS2SHARE) in library 1, and from finer OS/2 BBSs everywhere.
  35.  
  36.  
  37. Installing and starting the Taskbar:
  38. ===================================
  39.  
  40. First, unpack the archive into a (preferably empty) directory.  Now run
  41. the TINSTAL.CMD file to create a WPS object for the Taskbar.  You're
  42. given a choice to create the object on the Desktop or in the Startup
  43. folder.  You're done.
  44.  
  45. Once the object is created, double-click it to run it.  If the object is
  46. in the Startup folder, OS/2 will start it every time you boot up OS/2.
  47.  
  48.  
  49. Using the Taskbar:
  50. =================
  51.  
  52. Here's a simple diagram showing the layout of the Taskbar:
  53.  
  54.  ┌───────────────────────────────────────────────────────────────────────────┐
  55.  │                                                                           │
  56.  │                                                                           │
  57.  │                                                                           │
  58.  │                                                                           │
  59.  │                                                                           │
  60.  ┴─────────────────────────────────\/\───────────────────────────────────────┴
  61.                                  Desktop
  62.  ┬─────────────────────────────────/\/───────────────────────────────────────┬
  63.  │                                                                           │
  64.  │                                                                           │
  65.  │    ┌──Taskbar                                                             │
  66.  │    │                                                                      │
  67.  │    │                                                                      │
  68.  ├────┴─┬─┬─┬─┬──────────────────────────────────────────────────────────────┤
  69.  │ Time/├─┼─┼─┤┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐        │
  70.  │ Date ├─┼┼┼─┤└──┘ └──┘ └──┘ └──┘ └┬─┘ └──┘ └──┘ └──┘ └──┘ └──┘ └─┬┘        │
  71.  └──────┴─┴┼┴─┴─────────────────────┼──────────────────────────────┼─────────┘
  72.            └──Virtual desktops      └──Icons of running programs───┘
  73.  
  74. After starting the Taskbar from the WPS object the TINSTAL.CMD program
  75. creates for you, move the mouse pointer to the bottom of the screen.
  76. The Taskbar pops up and remains up as long as you keep the mouse pointer
  77. within its window.  When you move the mouse outside the window, the
  78. window vanishes until you call it up again.  This "popup" action ensures
  79. that the Taskbar isn't occupying valuable Desktop space when you don't
  80. need it, but is always available when you do.
  81.  
  82. As you pass the mouse pointer over the icons of running programs, a
  83. caption window appears showing the name of the program the icons
  84. represent.  Click on one of these icons with mouse button one (usually
  85. the left button), and the program is brought to the foreground, and is
  86. restored if it was hidden or minimized.  You can request a context menu
  87. on these icons (click mouse button two, usually the right button) for
  88. more options (Show, Hide, Move to this desktop, Close and Kill).  The
  89. "current" window is shown extruded (an outtie instead of an innie, in
  90. navel terms -- jelly baby, anyone?).
  91.  
  92. The Time/Date field can be double-clicked to bring up a Settings
  93. notebook to allow you to set the time and date.  A context menu
  94. requested on this field is the same as a context menu requested over an
  95. empty part of the Taskbar, with various options to control how the
  96. Taskbar operates, and to close the Taskbar (we'll get to that in a
  97. moment).  If you have a three-button mouse and a driver that recognizes
  98. the third button, clicking it in this field will display the system
  99. clock (assuming you haven't told the Taskbar to change button three
  100. presses to button one double-clicks in the Taskbar settings -- see
  101. below).
  102.  
  103. The Virtual desktop field allows you to have nine separate workspaces on
  104. your desktop.  Click mouse button one in one of the nine squares of the
  105. grid, and the desktop "switches" to that workspace.  (If you close the
  106. Taskbar, all programs are brought onto the actual desktop so none are
  107. left stranded where you can't get to them without a lot of work.)
  108. Requesting a context menu on this field allows you to start command
  109. lines or open FM/2 or several WPS objects.  The context menu also allows
  110. you to hide or restore all open windows.
  111.  
  112. Requesting a context menu on the Time/Date field or any empty part of
  113. the Taskbar brings up a menu that allows you to change Taskbar settings
  114. or close (exit) the Taskbar.  An About box and (very) brief help are
  115. available here as well.
  116.  
  117.   Dialog:  Opens a dialog where you can adjust the Taskbar settings.
  118.   This is the default for this conditional cascade submenu.  In the
  119.   dialog, you can set what part of the bottom of the screen will
  120.   activate the taskbar, how low the mouse pointer must go in that area,
  121.   and whether the taskbar window is "animated" or not.
  122.  
  123.   Button 2 send to bottom:  If checked, clicking mouse button two on a
  124.   window's titlebar will send it to the bottom of the window stack (all
  125.   other open windows will appear on top of it).  Hold down the Shift key
  126.   to temporarily override this action.
  127.  
  128.   Button 3 close:  If checked, clicking mouse button three on a window's
  129.   titlebar will close the application.  Hold down the Shift key to
  130.   temporarily override this action.
  131.  
  132.   Button 3 = B1 dbl clk:  If checked, the Taskbar translates a click of
  133.   mouse button three (the center button on three-button mice) to a
  134.   double-click of mouse button 1.  The WPS doesn't use button three
  135.   directly, so this may be a way to get some use out of it.  You can
  136.   hold down the Shift key to temporarily override this action.
  137.  
  138.   Sliding focus:  If checked, windows below the mouse pointer will be
  139.   activated and brought to the top of the window stack.  Holding down
  140.   the Shift key temporarily overrides this action.
  141.  
  142.   No zorder change:  Works in conjunction with Sliding focus.  If
  143.   checked, windows will be activated but NOT brought to the top of the
  144.   window stack.  Hold CTRL to temporarily override this action.
  145.  
  146.   Reposition mouse on show:  If checked, when you use the Taskbar icons
  147.   to Show a window, the mouse pointer will be placed in the center of
  148.   the window.
  149.  
  150.   Move folders:  If not checked, the Taskbar always keeps WPS folders on
  151.   the current desktop.
  152.  
  153.   Disable desktops:  Disables the virtual desktop feature of the
  154.   Taskbar.
  155.  
  156.   Reloading and editing exclude lists:  See "Advanced topics" below;
  157.   normally, you don't need to worry about this at all.
  158.  
  159. My best advice to you regarding the settings above is to simply try them
  160. and see what you like best.  You can't destroy your computer or OS/2
  161. with them, so you've nothing to lose but the time it takes to turn
  162. something back off or on; relax and experiment.
  163.  
  164.  
  165. Advanced topics:
  166. ---------------
  167.  
  168. To exclude windows from the Taskbar display:  Enter their switch list
  169. titles (as shown in the Window List), one per line, in a file called
  170. "TEXCLUDE.LST" in the Taskbar's directory.  You can make this partial;
  171. if the first part of the window's switch list title matches the line
  172. in the file, it won't show on the Taskbar.  Use a standard text editor
  173. to create the file (E.EXE, the system editor, will work fine).
  174.  
  175. To exclude windows from being moved when you select a virtual desktop,
  176. enter their titlebar text, one per line, in a file called "VEXCLUDE.LST"
  177. in the Taskbar's directory.  You can make this partial as above.
  178.  
  179. You can reload an exclude list after you've edited it via menu
  180. selection.  Request a context menu on the Time/Date field or on a blank
  181. area of the Taskbar.  You can also open the files from the context menu;
  182. whatever editor you have assigned to the files via WPS associations is
  183. used.  After editing, don't forget to reload it.
  184.  
  185.  
  186. Uninstalling the Taskbar:
  187. ========================
  188.  
  189. If you try the Taskbar and decide you don't like it, run TUINSTAL.CMD
  190. in the Taskbar directory to remove it.  Thanks for giving it a shot;
  191. feel free to let me know what you didn't like.
  192.  
  193.  
  194. Troubleshooting:
  195. ===============
  196.  
  197. As with any non-trivial program, it's possible that the FM/2 Taskbar
  198. contains bugs.  If you encounter a bug, please do report it _in
  199. painstaking detail_ to one of the addresses at the bottom of this
  200. document.  Be sure to tell me how to duplicate the bug.
  201.  
  202. The only thing that I know of that could cause you problems with the
  203. Taskbar is the LIBPATH line in CONFIG.SYS.  This line should contain
  204. ".\" to allow TASKHOOK.DLL to be found in TASKBAR.EXE's default
  205. directory.  An example:
  206.   LIBPATH=.\;C:\OS2\APPS\DLL;C:\MMOS2\DLL;C:\OS2\DLL;C:\OS2\MDOS;C:\;
  207. This is the default for OS/2 installation, so you shouldn't encounter
  208. a problem.
  209.  
  210. The Taskbar is meant to run in conjunction with the WPS.  Some
  211. functionality will be missing if run without it, but it shouldn't blow
  212. up.
  213.  
  214.  
  215. Simple license statement:
  216. ========================
  217.  
  218. You are granted a license to try this shareware program (FM/2 Taskbar)
  219. for up to sixty (60) days, after which you must register FM/2 or
  220. discontinue use of the Taskbar (that's right, to register the Taskbar
  221. you register File Manager/2 and get both -- what a deal).  You can
  222. alternatively register _just_ the FM/2 Taskbar by sending $15.00 US to
  223. the address below (I'll try to get it added to CIS SWREG and BMT Micro,
  224. too), but it _won't_ get you FM/2 as well, or a credit if you decide to
  225. register FM/2 later, so think carefully.
  226.  
  227. Permission is granted to redistribute the unaltered shareware archive
  228. for a reasonable (read nominal, small) copying charge (FM/2 Taskbar may
  229. specifically not be packaged with a commercial book without requesting
  230. and obtaining permission (common courtesy -- remember, "copyright" means
  231. literally "the right to control who copies the material").  If you write
  232. a review on the FM/2 Taskbar, I'd certainly appreciate a courtesy copy
  233. of the review -- my wife collects them.).  All rights are reserved by
  234. the author.  That's me.
  235.  
  236. There is NO warranty.  Support is NOT guaranteed to unregistered users.
  237.  
  238.  
  239. Contact info:
  240. ============
  241.   Mark Kimes (CIS 74601,1327; Fidonet#1:380/16.0; (318)222-3455 data
  242.               mkimes@linux.secret.com)
  243.   542 Merrick
  244.   Shreveport, LA  71104  USA
  245.  
  246.  
  247. History:
  248. =======
  249. 1.02
  250.   o Taskbar switches to the virtual desktop containing the program that
  251.     was selected by icon, if required.
  252.   o You can turn off the virtual desktop if you want -- the "icon"
  253.     remains, but it won't respond to mouse clicks, except for context
  254.     menu requests.
  255.   o Context menu items were added to allow you to edit exclude files
  256.     with a click -- it just loads the appropriate file into the system
  257.     editor using the default OS/2 association.  You can change editors
  258.     by setting a different association on the files or adding them to
  259.     the associations of the editor.
  260.   o The taskbar now hides itself _before_ bringing programs to the front.
  261.   o Added a toggle to make the taskbar window animated or not, for those
  262.     who like that sort of thing.
  263.   o Modified registration policy by popular demand (sheesh, who woulda
  264.     thought folks would want to buy it alone?  The program was written
  265.     during some experimenting I was doing, and I really only initially
  266.     released it as an advertisement for FM/2).
  267.